Microsoft DirectX 8.1 (C++)

IVMRSurface Interface

This topic applies to Windows XP Home Edition and Windows XP Professional only.

The IVMRSurface interface is implemented by the media samples returned by the VMR to upstream filters. Filters can use this interface to access the underlying DirectDraw surface on which the media sample is based. Filters must always lock and unlock the surface using the methods available on this interface. Filters must never call lock or unlock directly on the DirectDraw surface interface returned from the GetSurface method. Applications do not use this interface.

In addition to the methods inherited from IUnknown, the IVMRSurface interface exposes the following methods:

Method Description
GetSurface Retrieves the attached DirectDraw surface interface.
IsSurfaceLocked Indicates whether the DirectDraw surface attached to this media sample is locked.
LockSurface Locks the attached DirectDraw surface.
UnlockSurface Unlocks the attached DirectDraw surface.